home *** CD-ROM | disk | FTP | other *** search
/ TPUG - Toronto PET Users Group / TPUG Users Group CD / TPUG Users Group CD.iso / CRS / crs04.d81 / disklist.sda / DISK LIST 2 DOCS next >
Text File  |  2009-10-10  |  7KB  |  164 lines
  1.  
  2. ┴UGUST, 1986             ─ISK ╠IST ╓ERSION 2
  3.  
  4.  
  5.  
  6.  
  7. ─ISK ╠IST IS A 100% MACHINE LANGUAGE DISK FILE CATALOG PROGRAM.
  8. ╔T WAS WRITTEN FOR THE FAST, EASY CATALOGING OF YOUR DISK FILES.
  9.  
  10.  
  11. ╘HE ╞EATURES:
  12.  
  13.  
  14.  - 800 FILES PER LIST.
  15.  - ╚ARDCOPY IN 80 OR 132 COLUMNS.
  16.  - ╧PTIONAL OUTPUT TO A DISK SEQUENTIAL FILE.
  17.  - ╞AST, EASY, DISK FILE ENTRY.
  18.  - ╧PTIONAL FOUR DIGIT DISK ID.
  19.  - ╞ILE NAME EXPANSION TO 22 CHARACTERS.
  20.  - ╫ILL WORK WITH MOST FASTLOAD CARTRIDGES.
  21.  - ┼XTENSIVE EDITOR; CAN EASILY EDIT EVERY DETAIL OF A FILE.
  22.  - ─╧╙ COMMANDS AVAILABLE.
  23.  
  24.  
  25. ╘HE ─IFFERENCES:
  26.  ╘HERE ARE MANY, MANY DISK CATALOG PROGRAMS FOR THE ├OMMODORE 64.
  27. ╙O WHAT MAKES THIS ONE DIFFERENT?  ╧NE BIG DIFFERENCE IS IT IS
  28. WRITTEN ╘╧╘┴╠╠┘ IN MACHINE LANGUAGE:  ╘HERE ARE ╬╧ PAUSES FOR
  29. GARBAGE COLLECTIONS; DIRECTORIES ARE READ ╞┴╙╘; AND THE CODE SIZE IS
  30. VERY COMPACT TO ALLOW 51K OF FREE MEMORY FOR THE LIST. ╘HE LIST IS
  31. KEPT IN ╥┴═.  ╘HIS LIMITS HOW MANY FILES CAN BE KEPT IN A LIST, BUT
  32. MAKES FOR VERY FAST RETRIEVAL, EDITING, AND ALPHABETIZATION.  ╠ISTS
  33. CAN BE SAVED UNDER ALMOST ANY FILENAME, SO IN ESSENCE YOU CAN HAVE
  34. MUCH MORE THAN 800 FILES CATALOGED.  ╘HIS PROGRAM WAS WRITTEN AS A
  35. ╞╔╠┼ CATALOG PROGRAM.  ╔T IS MEANT TO CATALOG INDIVIDUAL FILES, NOT
  36. AN ENTIRE DISK.  ╘HUS IT DOES NOT HAVE A 'CATALOG ENTIRE DISK'
  37. OPTION.  ┘OU SHOULD PICK OUT THE INDIVIDUAL FILE(S) ON A DISK THAT
  38. YOU WISH TO ADD TO THE LIST.
  39.  
  40. ╘HE ├OMMANDS:
  41.  
  42.  1) ┴── ┴ ─╔╙╦
  43.    ─ISK ╠IST WILL READ IN THE ENTIRE DIRECTORY (144 NAMES) OF THE
  44. DISK IN DRIVE 8.  ╔T WILL THEN ASK YOU IF YOU WISH TO CATALOG THE
  45. FILES ON THIS DISK.  ┼NTER "┘" IF YOU DO.  ┘OU CAN THEN GIVE AN
  46. OPTIONAL 4 DIGIT DISK ID.  ╬EXT YOU WILL BE PRESENTED WITH A SCREEN
  47. WITH THE FIRST PART OF THE DIRECTORY, WITH ONE FILE HIGHLIGHTED.
  48. ╒SE THE CURSOR UP/CURSOR DOWN KEYS TO SELECT THE FILE YOU WISH TO
  49. CATALOG.  ╨USH THE ╥┼╘╒╥╬ KEY TO CATALOG IT, OR IF YOU ARE ─ONE WITH
  50. THE DISK, ENTER "─" (FOR ─ONE) OR "╤".  ┴FTER YOU AGREE TO CATALOG A
  51. FILE YOU WILL BE PROMPTED TO ENTER THE NAME OF THE FILE AS YOU WISH
  52. TO RECORD IT.  ╔F YOU WANT THE NAME TO BE THE SAME AS THE ONE ON THE
  53. DISK, JUST PRESS THE RETURN KEY.  ╬OTE THAT YOU CAN ENTER UP TO 22
  54. CHARACTERS.  ╬EXT YOU CAN ENTER THE JOYSTICK PORT(S) THE FILE USES
  55. (DEFAULT IS NONE).  ╔F AT THIS POINT, YOU NOTICE A MISTAKE ENTER A
  56. "<-" (BACK ARROW) AND YOU WILL ABORT CATALOGING THAT FILE.
  57.  
  58.  2) ┴── ┴ ╞╔╠┼
  59.    ╘HIS OPTION WILL ALLOW YOU TO ADD A FILE TO THE LIST WITHOUT
  60. INSERTING A DISK INTO THE DRIVE.  ╘HIS IS USEFUL FOR DISKS WHERE
  61. COPY-PROTECTION HAS ERASED THE DIRECTORY.  ╘HE REST IS EXACTLY THE
  62. SAME AS ┴── ┴ ─╔╙╦ OPTION.
  63.  
  64.  3) ┴╠╨╚┴┬┼╘╔┌┼
  65.    ╘HIS WILL SORT THE FILES IN THE LIST.  ╘HE BORDER WILL FLASH SO
  66. YOU WON'T THINK THE PROGRAM HAS LOCKED UP.  ├-128'S WILL BANK IN THE
  67. 8502 ├╨╒.
  68.  
  69.  4) ╧╒╘╨╒╘ ┴ ╠╔╙╘
  70.    ╘HIS IS WHERE YOU CAN GET A HARDCOPY OF YOUR LIST OR SEND IT TO A
  71. ╙┼╤ENTIAL FILE ON A DISK.  ┘OU WILL BE PRESENTED WITH A MENU THAT
  72. WILL GIVE YOU THE CHOICE OF WHETHER YOU WANT TO SEND THE LIST TO
  73. YOUR PRINTER OR TO A ╙┼╤ FILE ON YOUR DISK DRIVE (MAKE SURE YOU HAVE
  74. ENOUGH ROOM!), WHETHER YOU WANT A FULL (VERBOSE) OR A BRIEF LISTING,
  75. WHETHER YOU WANT THE OUTPUT IN 132 OR 80 COLUMNS, OR IF YOU WANT TO
  76. GO BACK TO THE MAIN MENU.  ┴FTER YOU CHOOSE TO CONTINUE YOU WILL BE
  77. PROMTPED FOR A 20 CHARACTER PAGE HEADING.  ╘HE PRINTER OPTION
  78. CURRENTLY HAS ╬╧ SECONDARY ADDRESS INCLUDED (SEE TECHNICAL NOTES).
  79. ╔F YOU HAVE A PRINTER WITH A COMPRESSED PRINT MODE MAKE SURE THAT IT
  80. IS SET TO 132 COLUMNS BEFORE YOU TRY TO PRINT - THERE IS NO WAY TO
  81. SEND A COMMAND TO THE PRINTER FROM THE PROGRAM.
  82.  
  83.  5) ╙┴╓┼ ┴ ╠╔╙╘
  84.    ╘HIS WILL SAVE YOUR LIST TO DISK DRIVE 8 FOR LATER USE.
  85.  
  86.  6) ╠╧┴─ ┴ ╠╔╙╘
  87.    ╘HIS WILL LOAD A LIST YOU PREVIOUSLY SAVED.
  88.  
  89.  7) ┼─╔╘ ╘╚┼ ╠╔╙╘
  90.    ╔N THIS MODE YOU CAN EDIT OR VIEW THE FILES IN THE LIST.
  91.  
  92. ┼DITOR ├OMMANDS:
  93.  
  94.  ═ -  ╫ILL TAKE YOU BACK TO THE MAIN MENU.
  95.  ╬ -  ╙HOWS THE NEXT FILE IN THE LIST.
  96.  ╨ -  ╙HOWS THE PREVIOUS FILE IN THE LIST.
  97.  ─ -  ╫ILL DELETE THE FILE SHOWN.
  98.  ╞ -  ╞IND A FILE.  ┼NTER THE FIRST LETTERS OF THE FILE YOU ARE
  99.        SEEKING.  ╞OR EXAMPLE; ENTERING "┌╧╥" WILL FIND THE FIRST FILE
  100.        STARTING WITH THE LETTERS ┌╧╥.
  101.  ┼ -  ┼DIT THE FILE SHOWN.  ╚ERE YOU CAN CHANGE THE INFORMATION OF
  102.        EACH FILE.  ╨RESS THE RETURN KEY TO KEEP THE INFORMATION THE
  103.        SAME AT EACH PROMPT.  ┴T THE END YOU CAN SAVE THE CHANGES (┘),
  104.        RE-EDIT (╬), OR ┴BORT ALL CHANGES THAT YOU HAVE MADE (┴).
  105.  
  106.  8) ─╔╙╦ ├╧══┴╬─╙
  107.    ╚ERE YOU CAN SEND ─╧╙ COMMANDS TO YOUR DISK DRIVE.  ╨RESSING THE
  108. RETURN KEY WITH NO COMMAND WILL DISPLAY THE DRIVE STATUS.  ╔F YOU
  109. ENTER A "$" (DOLLAR SIGN) THE DIRECTORY WILL BE SHOWN (IT WILL NOT BE
  110. LOADED INTO MEMORY).  ╘O PAUSE THE DIRECTORY FROM SCROLLING, PRESS
  111. THE SPACE BAR.
  112.  
  113.  
  114.  0) ┌┼╥╧ ╘╚┼ ╠╔╙╘
  115.    ┼NTERING "0" WILL CLEAR THE LIST AND RESET ALL POINTERS.
  116.  
  117.  
  118. ╔F YOU SHOULD FIND YOURSELF SOMEPLACE YOU DON'T WANT TO BE, PRESS THE
  119. ╥╒╬/╙╘╧╨ KEY ON THE LEFT SIDE OF THE KEYBOARD (─O ╬OT PRESS ╥┼╙╘╧╥┼).
  120. ╘HE CURRENT PROCESS WILL BE ABORTED.
  121.  
  122.  
  123. ╧PTIONAL ─ISK ╔─:
  124.  ═ANY PEOPLE HAVE NUMBERED THEIR DISKS WITH FOUR DIGIT ID'S TO BETTER
  125. KEEP TRACK OF THEM.  ╒SUALLY THE ID IS WRITTEN ON THE UPPER CORNER OF
  126. THE DISKS SO IT IS EASY TO ARRANGE THEM IN ORDER IN THEIR HOLDERS.
  127.  
  128.  
  129. ╧THER ╔DEAS:
  130. -╒SE THE DISK NAME SPACE FOR A SHORT DISCRIPTION OF THE FILE.
  131. -╒SE THE JOYSTICK CHARACTER FOR OTHER INFORMATION, LIKE
  132. DOCUMENTATION AVAILABLE (Y/N), FILE TYPE, OR BACKUP/ORIGINAL.
  133.  
  134.  
  135. ╘ECHNICAL ╬OTES:
  136.   ╘HIS PROGRAM RESIDES IN THE ╥┴═ UNDERNEATH THE ╦ERNAL ╥╧═
  137. ($┼000-$╞╞╞╞) WITH A JUMP TABLE LOCATED IN THE CASSETTE BUFFER.  ┴
  138. SAVED LIST HAS AS IT'S FIRST BYTE THE VERSION NUMBER (0), THE SECOND
  139. AND THIRD BYTE ARE THE NUMBER OF FILES IN THE LIST (IN HIGH BYTE,
  140. LOW BYTE FORMAT), AND THE NEXT 64 BYTES ARE THE FIRST RECORD.
  141. ╞ASTLOAD TYPE ╙╧╞╘╫┴╥┼ WILL NOT WORK WITH ─ISK ╠IST.  ╘HE SHIFT KEYS
  142. ARE DISABLED.  ═AKE SURE THAT THE SHIFT-LOCK KEY IS NOT SET.
  143.  
  144. ╨RINTER ╬OTES:
  145.   ╔F YOU NEED TO CHANGE THE SECONDARY ADDRESS, DO THE FOLLOWING:
  146. RESET YOUR COMPUTER, LOAD IN THE ─ISK ╠IST PROGRAM, TYPE IN
  147.  ╨╧╦┼ 6249,SA   WHERE 'SA' IS THE SECONDARY ADDRESS YOU WISH TO
  148. SEND.  ┼XAMPLE: TO SEND A SECONDARY ADDRESS OF 0 YOU WOULD TYPE
  149.  ╨╧╦┼ 6249,0.  ╘HE DEFAULT VALUE SHOULD BE 255.
  150.  
  151.  
  152. ╧NE FINAL NOTE:
  153.  ╘HIS PROGRAM IS ╞╥┼┼╫┴╥┼.  ┘OU ARE FREE TO COPY IT AND GIVE IT TO
  154. FRIENDS AND ENEMIES, ACQUAINTANCES AND STRANGERS.  ┴LL THAT ╔ ASK IS
  155. THAT IF YOU FIND THIS PROGRAM WORTHWHILE THAT YOU WOULD PLEASE SEND
  156. FIVE DOLLARS TO THE ADDRESS BELOW.  ┴NY COMMENTS OR SUGGESTIONS (AND
  157. ESPECIALLY ANY BUGS ╔ MISSED) ARE WELCOME.
  158.  ╘HANK YOU,
  159.  
  160.                    ┼RIC ┬RATTON
  161.                    4721 ╥ICHARD ╙TREET
  162.                    ╚OLT, ═╔  48842
  163.  
  164.